Revert "docs: Fix broken gtk-doc formatting"

This reverts commit a7562dd38fe86cfa26674f22d46fdfe24865ee13.

I prefer to not confuse gtk-doc with doc comments for private
functions.

diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index b13c87a42a4c576e4be641d5dae86f0a02f8ae26..066f5c434dc858473951a5743ec0dee9efb06d05 100644 (file)
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -378,7 +378,7 @@ gdk_cairo_set_source_window (cairo_t   *cr,
   cairo_surface_destroy (surface);
 }
 
-/**
+/*
  * _gdk_cairo_surface_extents:
  * @surface: surface to measure
  * @extents: (out): rectangle to put the extents

diff --git a/gdk/wayland/gdkwindow-wayland.c b/gdk/wayland/gdkwindow-wayland.c
index 715b0cf22d34b38eaa71246724e497c9ff40b184..f26c3e0c3a56b9d94815ee46c67e49d846ccfcd2 100644 (file)
--- a/gdk/wayland/gdkwindow-wayland.c
+++ b/gdk/wayland/gdkwindow-wayland.c
@@ -141,7 +141,7 @@ _gdk_window_impl_wayland_init (GdkWindowImplWayland *impl)
   impl->scale = 1;
 }
 
-/**
+/*
  * gdk_wayland_window_update_size:
  * @drawable: a #GdkDrawableImplWayland.
  *

diff --git a/gdk/x11/gdkmain-x11.c b/gdk/x11/gdkmain-x11.c
index 460392510a41ff763b8630ca5b40bf18319d79bd..22c7b95519db0b752799d4d9e4c8f39b2ff69192 100644 (file)
--- a/gdk/x11/gdkmain-x11.c
+++ b/gdk/x11/gdkmain-x11.c
@@ -137,7 +137,7 @@ _gdk_x11_convert_grab_status (gint status)
   return 0;
 }
 
-/**
+/*
  * _gdk_x11_window_grab_check_unmap:
  * @window: a #GdkWindow
  * @serial: serial from Unmap event (or from NextRequest(display)
@@ -169,7 +169,7 @@ _gdk_x11_window_grab_check_unmap (GdkWindow *window,
   g_list_free (devices);
 }
 
-/**
+/*
  * _gdk_x11_window_grab_check_destroy:
  * @window: a #GdkWindow
  * 

diff --git a/gtk/deprecated/gtkstock.h b/gtk/deprecated/gtkstock.h
index 13099c810a83f2bbec53f28261f44b5d996c740c..e02115bcb388006e6827d414d476be0d02443166 100644 (file)
--- a/gtk/deprecated/gtkstock.h
+++ b/gtk/deprecated/gtkstock.h
@@ -34,7 +34,7 @@
 
 G_BEGIN_DECLS
 
-/**
+/*
  * GtkTranslateFunc:
  * @path: The id of the message. In #GtkActionGroup this will be a label
  *   or tooltip from a #GtkActionEntry.

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 039bd12929f1d799ed011defa7c8eea2c4f078ec..383728d0b581a59de144ec5b1569d6bfbf4d902d 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -12381,7 +12381,7 @@ is_my_window (GtkWidget *widget,
   return (user_data == widget);
 }
 
-/**
+/*
  * _gtk_widget_get_device_window:
  * @widget: a #GtkWidget
  * @device: a #GdkDevice
@@ -12429,7 +12429,7 @@ list_devices (GtkWidget        *widget,
   g_list_free (devices);
 }
 
-/**
+/*
  * _gtk_widget_list_devices:
  * @widget: a #GtkWidget
  *
@@ -12499,7 +12499,7 @@ synth_crossing (GtkWidget       *widget,
   gdk_event_free (event);
 }
 
-/**
+/*
  * _gtk_widget_synthesize_crossing:
  * @from: the #GtkWidget the virtual pointer is leaving.
  * @to: the #GtkWidget the virtual pointer is moving to.
@@ -12806,7 +12806,7 @@ static const GtkWidgetAuxInfo default_aux_info = {
   { 0, 0, 0, 0 }
 };
 
-/**
+/*
  * gtk_widget_get_aux_info:
  * @widget: a #GtkWidget
  * @create: if %TRUE, create the #GtkWidgetAuxInfo-struct if it doesn’t exist
@@ -15545,7 +15545,7 @@ union_with_clip (GtkWidget *widget,
   gdk_rectangle_union (&widget_clip, clip, clip);
 }
 
-/**
+/*
  * _gtk_widget_set_simple_clip:
  * @widget: a #GtkWidget
  *